home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / ipcs.z / ipcs
Encoding:
Text File  |  2002-10-03  |  9.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. IIIIPPPPCCCCSSSS((((1111))))                                                                IIIIPPPPCCCCSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ipcs - report inter-process communication facilities status
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiippppccccssss [ options ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _i_p_c_s prints certain information about active inter-process communication
  16.      facilities for which the calling process has read access.  Without
  17.      _o_p_t_i_o_n_s, information is printed in short format for message queues,
  18.      shared memory, and semaphores that are currently active in the system.
  19.      Otherwise, the information that is displayed is controlled by the
  20.      following _o_p_t_i_o_n_s:
  21.  
  22.      ----qqqq      Print information about active message queues.
  23.  
  24.      ----mmmm      Print information about active shared memory segments.
  25.  
  26.      ----ssss      Print information about active semaphores.
  27.  
  28.  
  29.      If any of the options ----qqqq, ----mmmm, or ----ssss are specified, information about only
  30.      those indicated will be printed.  If none of these three are specified,
  31.      information about all three will be printed subject to these options:
  32.  
  33.  
  34.      ----bbbb   Print biggest allowable size information.  (Maximum number of bytes
  35.           in messages on queue for message queues, size of segments for shared
  36.           memory, and number of semaphores in each set for semaphores.)  See
  37.           below for meaning of columns in a listing.
  38.  
  39.      ----cccc   Print creator's login name and group name.  See below.
  40.  
  41.      ----oooo   Print information on outstanding usage.  (Number of messages on
  42.           queue and total number of bytes in messages on queue for message
  43.           queues and number of processes attached to shared memory segments.)
  44.  
  45.      ----pppp   Print process number information.  (Process ID of last process to
  46.           send a message and process ID of last process to receive a message
  47.           on message queues and process ID of creating process and process ID
  48.           of last process to attach or detach on shared memory segments)  See
  49.           below.
  50.  
  51.      ----tttt   Print time information.  (Time of the last control operation that
  52.           changed the access permissions for all facilities.  Time of last
  53.           _m_s_g_s_n_d and last _m_s_g_r_c_v on message queues, last _s_h_m_a_t and last _s_h_m_d_t
  54.           on shared memory, last _s_e_m_o_p(2) on semaphores.)  See below.
  55.  
  56.      ----aaaa   Use all print _o_p_t_i_o_n_s.  (This is a shorthand notation for ----bbbb, ----cccc,
  57.           ----oooo, ----pppp, and ----tttt.)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIIPPPPCCCCSSSS((((1111))))                                                                IIIIPPPPCCCCSSSS((((1111))))
  71.  
  72.  
  73.  
  74.      ----CCCC _c_o_r_e_f_i_l_e
  75.           Use the file _c_o_r_e_f_i_l_e in place of ////ddddeeeevvvv////kkkkmmmmeeeemmmm.
  76.  
  77.      ----NNNN _n_a_m_e_l_i_s_t
  78.           The argument will be taken as the name of an alternate _n_a_m_e_l_i_s_t
  79.           (////uuuunnnniiiixxxx is the default).
  80.  
  81.      The column headings and the meaning of the columns in an _i_p_c_s listing are
  82.      given below; the letters in parentheses indicate the _o_p_t_i_o_n_s that cause
  83.      the corresponding heading to appear; aaaallllllll means that the heading always
  84.      appears.  Note that these _o_p_t_i_o_n_s only determine what information is
  85.      provided for each facility; they do _n_o_t determine which facilities will
  86.      be listed.
  87.  
  88.      TTTT      (all)    Type of the facility:
  89.                          qqqq     message queue;
  90.                          mmmm     shared memory segment;
  91.                          ssss     semaphore.
  92.      IIIIDDDD     (all)    The identifier for the facility entry.
  93.      KKKKEEEEYYYY    (all)    The key used as an argument to _m_s_g_g_e_t, _s_e_m_g_e_t, or _s_h_m_g_e_t
  94.                      to create the facility entry.  (Note:  The key of a
  95.                      shared memory segment is changed to IIIIPPPPCCCC____PPPPRRRRIIIIVVVVAAAATTTTEEEE when the
  96.                      segment has been removed until all processes attached to
  97.                      the segment detach it.)
  98.      MMMMOOOODDDDEEEE   (all)    The facility access modes and flags:  The mode consists
  99.                      of 11 characters that are interpreted as follows:
  100.                      The first two characters are:
  101.                           RRRR   if a process is waiting on a _m_s_g_r_c_v;
  102.                           SSSS   if a process is waiting on a _m_s_g_s_n_d;
  103.                           DDDD   if the associated shared memory segment has been
  104.                               removed.  It will disappear when the last
  105.                               process attached to the segment detaches it;
  106.                           CCCC   if the associated shared memory segment is to be
  107.                               cleared when the first attach is executed;
  108.                           ----   if the corresponding special flag is not set.
  109.  
  110.                      The next 9 characters are interpreted as three sets of
  111.                      three bits each.  The first set refers to the owner's
  112.                      permissions; the next to permissions of others in the
  113.                      user-group of the facility entry; and the last to all
  114.                      others.  Within each set, the first character indicates
  115.                      permission to read, the second character indicates
  116.                      permission to write or alter the facility entry, and the
  117.                      last character is currently unused.
  118.  
  119.                      The permissions are indicated as follows:
  120.  
  121.                           rrrr   if read permission is granted;
  122.                           wwww   if write permission is granted;
  123.                           aaaa   if alter permission is granted;
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIIPPPPCCCCSSSS((((1111))))                                                                IIIIPPPPCCCCSSSS((((1111))))
  137.  
  138.  
  139.  
  140.                           ----   if the indicated permission is _n_o_t granted.
  141.      OOOOWWWWNNNNEEEERRRR  (all)    The login name of the owner of the facility entry.
  142.      GGGGRRRROOOOUUUUPPPP  (all)    The group name of the group of the owner of the facility
  143.                      entry.
  144.      CCCCRRRREEEEAAAATTTTOOOORRRR(a,c)    The login name of the creator of the facility entry.
  145.      CCCCGGGGRRRROOOOUUUUPPPP (a,c)    The group name of the group of the creator of the
  146.                      facility entry.
  147.      CCCCBBBBYYYYTTTTEEEESSSS (a,o)    The number of bytes in messages currently outstanding on
  148.                      the associated message queue.
  149.      QQQQNNNNUUUUMMMM   (a,o)    The number of messages currently outstanding on the
  150.                      associated message queue.
  151.      QQQQBBBBYYYYTTTTEEEESSSS (a,b)    The maximum number of bytes allowed in messages
  152.                      outstanding on the associated message queue.
  153.      LLLLSSSSPPPPIIIIDDDD  (a,p)    The process ID of the last process to send a message to
  154.                      the associated queue.
  155.      LLLLRRRRPPPPIIIIDDDD  (a,p)    The process ID of the last process to receive a message
  156.                      from the associated queue.
  157.      SSSSTTTTIIIIMMMMEEEE  (a,t)    The time the last message was sent to the associated
  158.                      queue.
  159.      RRRRTTTTIIIIMMMMEEEE  (a,t)    The time the last message was received from the
  160.                      associated queue.
  161.      CCCCTTTTIIIIMMMMEEEE  (a,t)    The time when the associated entry was created or
  162.                      changed.
  163.      NNNNAAAATTTTTTTTCCCCHHHH (a,o)    The number of processes attached to the associated shared
  164.                      memory segment.
  165.      SSSSEEEEGGGGSSSSZZZZ  (a,b)    The size of the associated shared memory segment.
  166.      CCCCPPPPIIIIDDDD   (a,p)    The process ID of the creator of the shared memory entry.
  167.      LLLLPPPPIIIIDDDD   (a,p)    The process ID of the last process to attach or detach
  168.                      the shared memory segment.
  169.      AAAATTTTIIIIMMMMEEEE  (a,t)    The time the last attach was completed to the associated
  170.                      shared memory segment.
  171.      DDDDTTTTIIIIMMMMEEEE  (a,t)    The time the last detach was completed on the associated
  172.                      shared memory segment.
  173.      NNNNSSSSEEEEMMMMSSSS  (a,b)    The number of semaphores in the set associated with the
  174.                      semaphore entry.
  175.      OOOOTTTTIIIIMMMMEEEE  (a,t)    The time the last semaphore operation was completed on
  176.                      the set associated with the semaphore entry.
  177.  
  178. FFFFIIIILLLLEEEESSSS
  179.      /unix         system namelist
  180.      /dev/kmem     memory
  181.      /etc/passwd   user names
  182.      /etc/group    group names
  183.  
  184. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  185.      msgop(2), semop(2), shmop(2)
  186.  
  187. BBBBUUUUGGGGSSSS
  188.      Things can change while _i_p_c_s is running; the picture it gives is only a
  189.      close approximation to reality.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.